QuickShot Arcade Mania 2/QuickShot Arcade Mania 2.iso/menu-f/guide.txt

Text File | 1993-06-14 | 44KB | 1,103 lines

                         Magic Desk (tm)
                           Version 3.0

                          User's Guide

            Copyright 1991-1993 Virtual Magic Software
                       All Rights Reserved


                      Virtual Magic Software
                          P.O. Box 12264
                  Huntsville, Alabama 35815-0264

                     CompuServe:  70304,2045
                        Prodigy:  CJKH33A
               Internet:  [e-mail]



WARRANTY AND LICENSE...........................................2

INTRODUCTION...................................................2

SYSTEM REQUIREMENTS............................................3

INSTALLING MAGIC DESK..........................................3

STARTING MAGIC DESK............................................3

MOVING AROUND IN MAGIC DESK....................................4

ADDING A PROGRAM OR PAGE.......................................6

REMOVING A PROGRAM OR PAGE.....................................9

VIEWING/MODIFYING A PROGRAM OR PAGE............................9

SETTING CONFIGURATION OPTIONS.................................10

SETTING COLOR OPTIONS.........................................12

SETTING SCREEN BLANKER OPTIONS................................12

RUNNING PROGRAMS FROM MAGIC DESK..............................13

ARRANGING BUTTONS.............................................14

PAINTER.......................................................15

TIPS AND TECHNIQUES...........................................17

COMPATIBILITY WITH EARLIER VERSIONS...........................20


====================
WARRANTY AND LICENSE
====================

THIS PROGRAM IS SUPPLIED AS IS.  THE AUTHOR DISCLAIMS ALL
WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,
THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.
THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR
CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS PROGRAM.

This is an unregistered evaluation version of Magic Desk.  You are
licensed to use this version for a reasonable evaluation period,
up to 30 days.  If after the evaluation period you wish to
continue using Magic Desk, you must submit the required
registration fee.  There are several advantages to becoming a
registered user.  Please see the REGISTER.TXT file for complete
registration details.


============
INTRODUCTION
============

Magic Desk is a graphical DOS menuing system that lets you easily
run all of your programs without having to remember cryptic DOS
commands.  Magic Desk is unique because it has all the advanced
features found in menuing systems designed for adults, yet it is
so safe and simple that even young children can use it.  It's
incredibly easy to set up your programs to run from Magic Desk.
Simply enter the program title, where the program is on disk, and
the name of the icon you want to use to represent the program.
File pick-lists make your job even easier.  Magic Desk will create
a large 3-D button with the icon you've chosen.  From then on, you
can start the program simply by selecting the button with the
mouse or keyboard.  When your program is finished, Magic Desk
automatically reappears so you can select another program.  It
couldn't be any easier!

You can use readily available Microsoft Windows icons, or you can
design your own with the easy-to-use icon editor built into Magic
Desk.  Magic Desk allows you to set up multiple levels of menu
pages which can hold a virtually unlimited number of programs.
You can password protect individual programs or entire menu pages.
You can assign hotkeys to run particular programs or open menu
pages.  You also have the option of providing variable program
parameters at the time you run a program.  Magic Desk has a built-
in screen blanker and usage log.  It also allows you to use PCX
files as background images.  Magic Desk does not remain in memory
while it is running your programs.






                                2
===================
SYSTEM REQUIREMENTS
===================

- MS-DOS 3.0 or later
- EGA/VGA
- 512K RAM
- Hard Disk
- Microsoft-compatible Mouse (optional)


=====================
INSTALLING MAGIC DESK
=====================

Magic Desk is distributed in a compressed format and cannot be run
directly as is.  You must first install it on your hard drive.  To
install it:

     1.  When you see the C> prompt (or a similar prompt that
identifies your hard drive), insert the program disk in disk drive
A (or B).

     2.  Type A:INSTALL (or B:INSTALL) and press the ENTER key.

     3.  Follow the instructions on the screen.


===================
STARTING MAGIC DESK
===================

To start Magic Desk at the DOS prompt, type MAGIC then press
ENTER.

Magic Desk automatically detects whether your system has an EGA or
VGA compatible graphics card and switches to the highest graphics
mode available.  It will also detect the presence of a mouse if
you have a Microsoft-compatible mouse driver installed.  If you
have display problems, such as part of the main Magic Desk page
not being visible, or the mouse pointer not displaying, Magic Desk
may not be correctly detecting the video mode.  You can try to
force Magic Desk into the correct graphics mode by typing "MAGIC
E" for EGA or "MAGIC V" for VGA.  If the mouse pointer still
doesn't display, check to ensure you have a mouse driver properly
installed.

If you would like Magic Desk to run automatically when you turn on
your computer, you can include the appropriate commands in your
AUTOEXEC.BAT file.  See the "Tips and Techniques" section of this
User's Guide for complete details.



                                3
===========================
MOVING AROUND IN MAGIC DESK
===========================

When you open a window, such as the Helper window described later,
it pops up on top of the current page and any windows that may
already be displayed.  The top window is always the active window.
You can only access objects (normally buttons and text boxes) that
are in the active window.


SELECTING OBJECTS - MOUSE

Move the mouse pointer to the desired object in the active window
and click any of the mouse buttons once.  In Magic Desk all mouse
buttons have the same effect, and no double clicks are required.


SELECTING OBJECTS - KEYBOARD

     1)  ALT Key:  Objects can be selected by pressing the ALT key
plus a letter key.  Most objects have one or more words under them
or to the right of them describing the function of the button or
box.  One of the letters in the words will have an underscore
beneath it.  To select the object, hold down the ALT key and press
the letter that is underscored.  For example, at the Helper
window, to select the Remove Program or Page button, hold down the
ALT key and press "R".  Some buttons don't have text descriptions.
The keys to select these buttons are:

     - STOP Button:  ALT+S (only at title page)
     - Painter Button:  ALT+P (only at title page)
     - Information Button:  ALT+I (only at title page )
     - Close Window Button:  ESC
     - Helper Button:  ALT+H
     - OK Button:  ALT+O
     - Arrange Icons:  ALT+A
     - Up-Arrow Button:  Page Up
     - Down-Arrow Button:  Page Down

     2)  Outline Cursor:  In some windows you must use the arrow
keys on your keyboard to move from one object to the next.  An
outline cursor will indicate the current object.  To select the
current object, press the ENTER key.  (If you have a mouse, this
outline cursor can be turned off if you intend to use only the
mouse to select objects.  See "Setting Configuration Options"
below for instructions.)







                                4
EDITING TEXT

In using Magic Desk, you will sometimes need to enter information
in text boxes.  This section describes the general procedures for
entering and editing text in text boxes.

     1)  Positioning the Text Cursor (Mouse):  Move the mouse
pointer directly to the desired location within any of the text
boxes in the active window and click one of the mouse buttons. The
text cursor (a thin black vertical line) will move to the mouse
pointer position.

     2)  Positioning the Text Cursor (Keyboard):  Select the
desired text box using the ALT key combinations, TAB/SHIFT-TAB, or
up and down arrow keys as described above.  Move around within the
text box by using the left and right arrow keys.  Pressing the TAB
key or ENTER key will move the text cursor to the next text box.
Pressing the TAB key while holding down SHIFT key will move the
text cursor to the previous text box.

     3)  Entering Text:  After positioning the text cursor, begin
typing.  The text will be inserted at the text cursor location.
Magic Desk will not allow you to enter more text than will fit
inside the text box.

     4)  Deleting Text:  To delete a character to the right of the
text cursor, press the DELETE key.  To delete a character to the
left of the text cursor, press the BACKSPACE key.


CLOSING THE ACTIVE WINDOW OR PAGE

The button in the upper left corner of the window or page is
always used to close the window and return to the previous window
or page.  Select this button with the mouse or press the ESCAPE
key.  If you have made changes to information in a window, be sure
to save the changes before closing the window.


SAVING CHANGES

After you have made changes, such as adding a new program or
changing the configuration, you must save these changes to disk.
Do this by selecting the OK button with the mouse or typing ALT+O.
If you decide you don't want the changes to be made, simply close
the window without saving them.








                                5
MOVING BETWEEN PAGES

Icon buttons can represent either programs or pages, depending on
how you have them set up (see "Adding a Program or Page" below).
Program buttons start a program when selected; page buttons open a
new page when selected.  Pages can be be nested five deep.  To
close the current page and return to the previous page, select the
button in the upper left corner of the page or press the ESCAPE
key.

USING FILE PICKLISTS

Magic Desk makes it easy for you to enter file information for
programs, icons, etc., by displaying file picklists.  Instead of
having to remember and type in the exact drive, directory and
filename for various files, you just have to locate the file in
the picklist and select it with the mouse or keyboard.

     1)  Available drives are indicated in the picklist with a
letter followed by a colon (":").  Selecting a drive from the
picklist will cause the files in the current directory on that
drive to be displayed.

          b.  Subdirectories of the current directory are
indicated in the picklist by a backslash ("\") at the end of the
name.  Selecting a subdirectory will cause the files for that
directory to be displayed.  Selecting the "..\" entry will display
the files of the parent directory of whatever directory you are
currently in.

          c.  Selecting a file from the picklist will close the
picklist window and automatically fill in the appropriate text box
or boxes with the file information.  If the file list contains
more than 16 drives, directories and files, select the blue arrow
buttons (or press the Page Up and Page Down keys) to display the
next or previous 16 files.  Magic Desk will only display the first
1024 file names in any directory.


========================
ADDING A PROGRAM OR PAGE
========================

Open the Helper window by selecting the Helper button (the red
cross) or by typing ALT+H.  Select the Add Program or Page button.
This will open a window containing the following objects:

     1)  Program Files Button:  Select this button to open a file
picklist of all program (COM, EXE, and BAT) files.  Selecting a
file from this picklist will automatically fill in the Path and
Program text boxes (see 8 and 9 below).



                                6
     2)  Icon Files Button:  Select this button to open a file
picklist of all Magic Desk icon (ICN) files.  Selecting a file
from this picklist will automatically fill in the Icon text box
(see 10 below) and display the icon in the box at the bottom of
the window.

     3)  Copy Button:  Select this button to copy all information
currently in the Add Program or Page window to a temporary storage
area in memory or "clipboard".  This information can later be
pasted into another program or page button being added or
modified. (NOTE:  Copying the information for a page button also
causes the information about all the program buttons on that page
to be copied.  Magic Desk will not let you copy the information
for a page button if the page represented by the button contains
page buttons itself (i.e. if the page contains subpages)).  The
copied information remains in the clipboard until you: (1)
overwrite it by using the Copy button again; (2) run an
application; or (3) exit Magic Desk.

     4)  Paste Button:  Select this button to paste program or
page information, previously copied to the clipboard with the Copy
button, to the current window.  This is useful if you want to
duplicate the same program button on more than one page or copy
the contents of a page to a new page.

     5)  Button Title Text Box:  Enter a title for the program or
page button.  This will be the title that will appear under the
button.  If you are entering information for a page button, this
will also be the title at the top of the page when it is opened.

     6)  Password Text Box:  You can enter an optional password
that a user must enter to start the program or open the page.
Passwords are always displayed on the screen as a series of
asterisks.  This prevents someone looking over your shoulder from
viewing the password on the screen.  If you forget the password
there is no way to look it up.  You will have to enter a new
password.

     7)  Key Text Box:  You can enter an optional hotkey to be
used to select the program or page.  You can use any printable
character as a hotkey.  Upper and lower case letters are treated
as the same letter.  Ensure that no two program/page buttons on
the same page have the same hotkey, or Magic Desk will always
select the first one it finds.  These are not ALT key
combinations.  If you enter "M" as the hot key to run a "Mickey
Mouse" program, you will just press the "M" key to run the
program, not ALT+M.

     8)  Path Text Box:  Enter the drive/directory of the program.
The easiest way to do this is to use the Program Files button,
which will automatically fill in the correct information for both



                                7
Path and Program text boxes.  Drive information is optional if the
file is on the same drive as Magic Desk.  Directory information is
optional if the file is in the same directory as Magic Desk or one
of the directories listed in the DOS PATH statement.  The
directory must begin with a backslash ("\").

     Example:  C:\NATHAN\GAMES\

     9)  Program Text Box:  Enter the command to execute the
program, plus any optional parameters.

     Example:  MICKABC /E

     10)  Icon Text Box:  Enter the complete path and filename of
the icon to be displayed on the button.  The easiest way to do
this is to use the Icon Files button described above, which will
automatically fill in the correct information.  Drive information
is optional if the icon file is on the same drive as Magic Desk.
Directory information is optional if the icon is in the same
directory as Magic Desk.  The directory must begin with "\".

     Example:  C:\ICONS\ABC.ICN

Magic Desk can only use icons in Magic Desk format, normally
represented by a ".ICN" extension.  These icons can be designed
using the Painter icon editor built into Magic Desk.  A number of
sample icons are included on the Magic Desk disk.  For
instructions on designing your own icons or importing Microsoft
Windows icons, see the "Painter" section below.

     11)  Page Button:  Icon buttons can represent either a
program to be launched or a page (submenu) to be opened.  Setting
the Page button to "YES" indicates that information being entered
is for a button that will be used to open a page.  In this case,
anything entered in the Program and Path text boxes is ignored.
Magic Desk allows up to five nested levels of pages.

     12)  Batch File Button:  Set this to "YES" if the program is
a batch file (a file with a ".BAT" extension), otherwise the
program will not return to Magic Desk after it runs.  Another
option for running a batch file (and actually the preferable
option) if you are using MS-DOS 3.3 or later, is to leave this set
to "NO" and precede the program name with the word "CALL" in the
"Program" text box.

          Example:  CALL PRODIGY.BAT

     13)  Wait Button:  Setting this to "YES" causes Magic Desk to
wait for ENTER to be pressed before returning to Magic Desk after
running the program.  This is useful if you need time to view the
results of the program before Magic Desk reappears.



                                8
     14)  Variables Button:  Setting this to "YES" allows you to
enter additional command line parameters at the time you run the
program.  This is useful if you sometimes run the same program
with different parameters.

     15)  OK Button:  After you have entered all necessary
information, select the OK button with the mouse or press ALT+O to
save the information to disk and close the window.  To close the
window without adding the program/page, select the Close Window
button in the upper left corner of the window or press the ESCAPE
key.


==========================
REMOVING A PROGRAM OR PAGE
==========================

Open the Helper window by selecting the Helper button (the red
cross) or by pressing ALT+H.  Select the Remove Program or Page
button.  This will open a window listing the names of all the
program/page buttons on the current page.  Select all of the
program/page buttons you wish to remove, then select the OK button
or press ALT+O.  To close the window without removing any
programs, select the Close Window button with the mouse or press
the ESCAPE key.

Removing a program button from Magic Desk does not delete the
program from disk.  It still exists and can be run normally from
DOS or later added back to Magic Desk.

After removing a program/page button, you may want to rearrange
the remaining buttons (see "Arranging Buttons" below ).

If you remove a button representing a page, all the program
buttons belonging to that page are also removed.  Magic Desk will
allow you to remove a button representing a page that contains
program buttons, but it will not allow you to remove a page button
that itself contains more subpages.  If you try to remove a page
button that has subpages, you will get a message saying "Pages
containing subpages were not removed."  To remove the button in a
case like this, you must first close the Helper window, open the
page containing the subpages, and remove all the subpages
individually.


===================================
VIEWING/MODIFYING A PROGRAM OR PAGE
===================================

Open the Helper window by selecting the Helper button (the red
cross) or by pressing ALT+H.  Select the View/Modify Program or



                                9
Page button.  This will open a window listing the names of all the
program and page buttons on the current page.  Select the
program/page button you wish to view or modify.  A window will
open containing the current information for that program/page
button.  You can make any desired changes using the same
techniques used in the Add Program or Page window.


=============================
SETTING CONFIGURATION OPTIONS
=============================

All pages have a Helper window which is used to add, remove or
view/modify buttons on that page.  The Helper window for the main
title page contains extra buttons for customizing how Magic Desk
looks and works.  Selecting the Configuration Options button opens
a window in which you set the following options.

     1)  Arrange Icons:  Setting this to "NO" prevents a user from
rearranging the buttons on any page (see "Arranging Buttons").

     2)  STOP Button:  Setting this to "NO" prevents a user from
exiting Magic Desk by disabling the STOP button on the main title
page.  To exit the program when the STOP button is disabled, a
user must press ALT+S.  As an additional level of security, you
can password protect the ALT+S function (see "Password" below).

     3)  Helper Button:  Setting this to "NO" prevents a user from
changing any page/program or configuration information by
disabling the Helper button (the red cross) on all pages.  To open
the Helper window when the Helper button is disabled, a user must
press ALT+H.  As an additional level of security, you can password
protect the ALT+H function (see "Password" below).

     4)  Disk Access:  Setting this to "NO" disables the Read Icon
and Write Icon buttons in Painter.  To access the Read Icon button
when disk access is disabled, a user must press ALT+R.  To access
the Write Icon button when disk access is disabled, a user must
press ALT+W.  As an additional level of security, you can password
protect the ALT+R and ALT+W functions (see "Password" below).

     5)  Usage Log:  Setting this to "NO" turns off the usage log.
When the Usage Log button is set to "YES", each time you run a
program from Magic Desk, information is recorded in a file called
USAGE.LOG.  The log records the program title, the date and time
the program was launched, and the elapsed time.  The log is in
standard ASCII text format, so you can view and/or print it from
any text editor or word processor.

     6)  Cursor:  Setting this to "NO" turns off the outline
cursor used to indicate the current object on pages.  If you do



                               10
not have a mouse installed you should leave this set to "YES".  If
you have a mouse installed, and you use only the mouse to select
objects, you can turn the cursor off if you find it distracting.

     7)  Main Title:  Enter a title up to 24 characters long that
will appear on the main title page.

     8)  Password:  You can enter an optional password that will
be required in three situations:  (1) when a user attempts to exit
the program with ALT+S; (2) when a user attempts to open the
Helper Window with ALT+H; or (3) when a user attempts to read or
write a disk file in Painter with ALT+R or ALT+W.  The same
password applies to all three situations.  This password has no
effect on individual programs or pages.  Passwords for these are
set in the Add Program or Page or the View/Modify Program or Page
windows.

    9)  PCX File:  Enter the complete path and filename of the PCX
file to be displayed as a background on the opening title page.
The easiest way to do this is to use the PCX Files button
described above, which will automatically fill in the correct
information.  Drive information is optional if the icon file is on
the same drive as Magic Desk.  Directory information is optional
if the icon is in the same directory as Magic Desk.  The directory
must begin with "\".

     Example:  C:\PCXFILES\CHESS.PCX

If the entire image will fit on the screen, Magic Desk will center
it vertically and horizontally.  If the image is larger than the
screen, Magic Desk will display as much of the image as possible,
beginning with the upper left corner of the image.

Magic Desk can only display 16-color PCX Files.  Many PCX files do
not use a standard color palette, which will cause unpredictable
colors when displayed in Magic Desk.  If you have access to a
system with Microsoft Windows you can use the Paintbrush accessory
that comes with Windows to change the palette to the one used by
Magic Desk and Windows.  Open Paintbrush and perform the following
steps:

          a.  Open the PCX file.
          b.  Save it as a PCX file with a different name.

Paintbrush will save the new file in the default palette.  After
the conversion, the colors in the image may not be exactly the
same as the original, but they will be very close.  You can then
use the new PCX file in Magic Desk.

     10)  OK Button:  After you have set the options the way you
want them, select the OK button with the mouse or press ALT+O.



                               11
This will save the current settings to disk and close the
Configuration Options window.  No changes take effect until they
are saved to disk.  To close the window without saving any
changes, select the small red Close Window button with the mouse
or press the ESCAPE key.


=====================
SETTING COLOR OPTIONS
=====================

All pages have a Helper window which is used to add, remove or
view/modify buttons on that page.  The Helper window for the main
Magic Desk title page contains extra buttons for customizing how
Magic Desk looks and works.  Selecting the Color Options button
opens a window in which you can customize the Magic Desk colors.

The Color Options window contains six buttons which allow you
change the colors of the background, title bar, title, text, text
box, and outline cursor.  The window also displays a miniature
representation of the screen, so you can see the results
immediately.  To change the colors, select the appropriate button
until the desired color appears.  Magic Desk will cycle through 16
colors and then start over again.

NOTE:  The outline cursor color will vary according to the color
of the background, so you should select the cursor color AFTER
selecting the background color.  The cursor color will also be
affected if you have a multicolor PCX image displayed in the
background on the main page.  Again, the cursor color will vary
according to what is behind it.

After you have set the options the way you want them, select the
OK button with the mouse or press ALT+O.  This will save the
current settings to disk and close the Helper window.  No changes
take effect until they are saved to disk.  To close the Helper
window without saving any changes, select the small red Close
Window button with the mouse or press the ESCAPE key.


==============================
SETTING SCREEN BLANKER OPTIONS
==============================

All pages have a Helper window which is used to add, remove or
view/modify buttons on that page.  The Helper window for the main
Magic Desk title page contains extra buttons for customizing how
Magic Desk looks and works.  Selecting the Screen Bkanker Options
button opens a window in which you can customize the the built-in
screen blanker.




                               12
The screen blanker built into Magic Desk can be used to blank the
monitor screen after a specified period of keyboard and/or mouse
inactivity.  If you often leave your computer on for extended
periods of time, this can lengthen the life of your monitor.  To
unblank the screen, simply press the space bar or move the mouse.
The screen will instantly reappear exactly as you left it.

In the Screen Blanker Options window you can set the following
options:

     1)  Blanker:  Set this button to YES to enable the screen
blanker.

     2)  Mouse:  If you have a mouse installed on your system, set
this button to YES.  This will cause the screen saver to recognize
mouse movements, as well as keystrokes, and not blank the screen
as long as it detects either.

     3)  Timer:  Enter a number between 0 and 59.  This number
determines the number of minutes after which the screen saver will
blank the screen if it has not detected any keyboard or mouse
activity.  If you enter a number less than zero, Magic Desk will
convert it to zero, which effectively disables the screen saver.
The screen will never blank as long as Timer is set to zero.  If
you enter a number greater than 59, Magic Desk will convert it to
59.  If you enter characters other than a valid number, Magic Desk
will convert it to zero.

     4)  OK Button:  After you have set the options the way you
want them, select the OK button with the mouse or press ALT+O.
This will save the current settings to disk and close the Screen
Blanker Options window.  No changes take effect until they are
saved to disk.  To close the window without saving any changes,
select the small red Close Window button with the mouse or press
the ESCAPE key.


================================
RUNNING PROGRAMS FROM MAGIC DESK
================================

After you have added a program button to Magic Desk, you can
easily run the program by: (1) selecting the program button with
the mouse; (2) selecting it with the arrow keys and pressing ENTER
(if the cursor is enabled); or (3) pressing the hot key associated
with the program.  If you have entered the path and program
information correctly, the program will start normally as it would
from the DOS command line.  When you exit the program, Magic Desk
will reappear.





                               13
If the program does not run correctly, use the View/Modify Program
or Page window to change the program information.  If the program
is a batch file and runs correctly, but does not return to Magic
Desk after running, ensure you have the Batch button set to "YES".


=================
ARRANGING BUTTONS
=================

As you add program/page buttons to Magic Desk, they are displayed
in rows of five, starting in the upper left position on the page.
You can rearrange the buttons in any order.  Before arranging the
buttons, you must set the Arrange Icons button in the
Configuration Options window to YES.  After you are finished
arranging the buttons, you may want to reset the Arrange Icons
button to NO.


MOVING BUTTONS - MOUSE

To move an icon button to a new location on the screen, position
the mouse pointer anywhere on the icon button and press one of the
mouse buttons.  While still holding down the mouse button, move
the mouse pointer to the location where you want the icon button
to be.  As you move the mouse, an outline of the icon button will
move with it.  After you have positioned the outline of the icon
button where you want it, release the mouse button.  The page will
redraw with the icon button in the new location.  (NOTE:  There is
small delay after holding the mouse button down before the button
outline begins to move.)


MOVING BUTTONS - KEYBOARD

To move an icon button to a new location on the screen, first
position the outline cursor on the button, using the arrow keys or
the TAB/SHIFT-TAB keys.  To move the button hold down the CTRL key
as you press the left arrow, right arrow, Page Up, and Page Down
keys.  (NOTE:  There are technical considerations with the IBM PC
keyboard which force us to use CTRL-Page Up and CTRL-Page Down
instead of CTRL-Up Arrow and CTRL-Down Arrow.)  As you press these
keys, the new position of the icon button will be indicated by an
outline of the button.  After you have positioned the outline of
the icon button where you want it, press the ENTER key.  The page
will redraw with the icon button in the new location.

IMPORTANT NOTE:  Pressing the ENTER key after moving an icon
button with the CTRL key combinations indicates to Magic Desk that
you have finished moving the button.  No other keys will work




                               14
until you press the ENTER key.  Also, if you have a mouse
installed, but choose to move an icon button with the CTRL key
combinations, do not click any of the mouse buttons before you
press the ENTER key.  Doing so will cause unpredictable results.


CHANGING THE ORDER

If you choose, you can move the icon buttons to any position on
the page and leave them there.  Although they may be in different
positions, Magic Desk still considers them to be in the same order
they were originally in.  Therefore, using the arrow keys and TAB
key to move the red cursor between objects may give you some
unexpected results.  If you use the mouse to select icon buttons,
this will not be a problem.

To change the actual order of the icon buttons and line them back
up in evenly spaced rows of five, move the buttons to the
approximate position you want them to be in, then press ALT+A.
The page will redraw with the icon buttons lined up evenly spaced
in the new order.


=======
PAINTER
=======

Painter is an icon editor built into Magic Desk.  With Painter you
can design your own 32x32 pixels, 16 color icons for programs you
install in Magic Desk, or you can import Microsoft Windows icons
and convert them to Magic Desk format.


PAINTING ICONS - MOUSE

Choose a color by selecting any of the 16 palette buttons with the
mouse.  The current color will always show in the box above the
palette buttons.  After selecting a color, position the mouse
pointer in the desired square on the large icon grid box, then
press any mouse button.  The square will change to the current
color.

To paint multiple squares with the same color, hold one of the
mouse buttons down while dragging the mouse pointer over the
squares you want to paint.  As you paint the icon on the large
grid box, you will also see the effects displayed on the actual-
size button to the right of the large grid box.







                               15
PAINTING ICONS - KEYBOARD

Choose a color by moving the red outline cursor to the desired
palette button with the arrow keys, then press the ENTER key.  The
current color will always show in the box above the palette
buttons.  After selecting a color, press the SPACEBAR.  This will
cause a small yellow grid cursor to appear in the large icon grid
box.  Move the grid cursor to the desired square using the arrow
keys, then press the ENTER key.  The square will change to the
current color.  When you are ready to select a new color, press
the SPACEBAR again.  The red outline cursor will appear again in
the palette buttons.

To paint multiple squares with the same color, hold down the CTRL
key as you press the left arrow, right arrow, Page Up, and Page
Down keys.  The squares will be painted as the grid cursor moves
over them.  (NOTE:  There are technical considerations with the
IBM PC keyboard which force us to use CTRL-Page Up and CTRL-Page
Down instead of CTRL-Up Arrow and CTRL-Down Arrow.  We realize
it's more awkward than it should be.)


FILL ALL BUTTON

Select this button to fill the entire grid with the current color.


READ ICON BUTTON

Select this button to read in an already-existing icon from disk.
Selecting this button will cause a window with a text box to pop
up.  Enter the path and file name of the icon file in the text
box.

     Example:  C:\ICONS\ABC.ICN

The easiest way to do this is to select the Icon Files button,
which will allow you to choose from a picklist of Magic Desk and
Windows icon files (ICN and ICO).

Drive information is optional if the icon file is the on same
drive as Magic Desk.  Directory information is optional if the
icon file is in the same directory as Magic Desk.  The directory
must begin with "\".  If you don't put an extension on the file
name, Painter will assume a ".ICN" extension.  After you have
entered the icon file information, press the ENTER key or select
the OK button to read the icon file.  The icon will be displayed
on the large icon grid box and the actual-size button to the
right.  To close the window without reading an icon, select the
red Close Window button.




                               16
WRITE ICON BUTTON

Select this button to save the displayed icon to a disk file.
Use the same procedures as described in the previous paragraph.


IMPORTING MICROSOFT WINDOWS ICON FILES

To import a Microsoft Windows icon file (normally with a ".ICO"
extension), read it in like you would a normal Magic Desk icon.
Painter will make the conversion as it reads the file in.  After
you have made any desired changes to the icon, write it to disk.
If you use the same file name, do not use the ".ICO" extension or
you will write over the Windows version of the icon file.  If you
don't specify an extension, Painter will attach a ".ICN"
extension.

Painter can only import MS Windows icons that are in 32x32x16
format (32 pixels by 32 pixels by 16 colors).  The vast majority
of MS Windows icon files available are in this format.  If you are
using a Windows program you may not be able to find any icon
files.  Most MS Windows programs do not have separate icon files.
Instead, the icons are stored in one of the program files (".EXE"
or ".DLL").  A single MS Windows program file can have several
icons stored in it.  Painter cannot extract the icons from these
files, but there are several utility programs available that can
extract the icons and put them into separate icon files that
Painter can import.


===================
TIPS AND TECHNIQUES
===================


RUNNING MULTIPLE COMMANDS

Magic Desk allows you to directly run one program or DOS command
per program button.  If you need to run a series of programs or
commands, you can do this by creating a batch file containing all
the necessary commands and setting up a program button to run the
batch file.

To easily create batch files you can set up a program button to
open your favorite text editor or word processor.  The text editor
that is included with MS-DOS 5.0 provides a quick, easy way to
create, view and edit batch files and other text files.  Here is a
sample setup for a program button to run the DOS editor from Magic
Desk:





                               17
     Button Title:  MS-DOS Editor        Page:        NO
     Password:      (your choice)        Batch File:  NO
     Key:           E                    Variables:   YES *
     Path:          C:\DOS\              WAIT:        NO
     Program:       EDIT
     Icon:          C:\MDESK\EDIT.ICN

     *  Setting Variables to "YES" will allow you to specify the
file to edit as a command-line parameter at the time you run the
editor.


FILE MANAGER

Magic Desk does not include built-in file management features, but
you can easily set up a program button to access your favorite
file management program.  The DOS Shell included with MS-DOS 5.0
provides a graphical file manager for copying, deleting and moving
files and directories.  Here is a sample setup for a program
button to run the DOS Shell program from Magic Desk:

     Button Title:  MS-DOS Shell         Page:        NO
     Password:      (your choice)        Batch File:  NO
     Key:           S                    Variables:   NO
     Path:          C:\DOS\              Wait:        NO
     Program:       DOSSHELL
     Icon:          C:\MDESK\SHELL.ICN


DOS COMMAND LINE

In some cases you may find that you need to execute a program or
DOS command from the DOS command line.  You have two choices.  The
first choice is to exit from Magic Desk, execute the command and,
when you're finished, start Magic Desk again.  A better solution,
particularly if you will need to do this on a recurring basis, is
to set up a program button to put you at the DOS command line
temporarily without exiting Magic Desk.  This is done by using the
COMMAND function of DOS.  The following sample program button,
when selected, will display the DOS prompt.  You can run any
programs/commands as you normally would from the command line.  To
return to Magic Desk, type EXIT at the command line and the
current Magic Desk page will reappear.

     Button Title:  MS-DOS Prompt        Page:        NO
     Password:      (your choice)        Batch File:  NO
     Key:           S                    Variables:   NO
     Path:          C:\DOS\              Wait:        NO
     Program:       COMMAND
     Icon:          C:\MDESK\DOS.ICN




                               18
MICROSOFT WINDOWS PROGRAMS

If you have a combination of DOS and Windows programs, you may
find it convenient to run Windows as a program under Magic Desk.
Since Magic Desk loads much faster than Windows, you won't have to
wait for Windows to load before you access your DOS programs.  You
can set up a program button to open Windows as follows:

     Button Title:  Microsoft Windows    Page:        NO
     Password:      (your choice)        Batch File:  NO
     Key:           W                    Variables:   NO
     Path:          C:\WINDOWS\          Wait:        NO
     Program:       WIN
     Icon:          C:\MDESK\WIN.ICN

Another technique is to set up a page called "Windows Programs"
and create separate program buttons for each of your Windows
applications.  To automatically load Windows and run a specific
Windows application, enter the Path and Program information as you
would for a normal DOS application, then precede the program name
with "WIN".  Here is a sample program button set up to load
Windows and run Quicken for Windows:

Button Title:  Quicken              Page:        NO
Password:      (your choice)        Batch File:  NO
Key:           W                    Variables:   NO
Path:          C:\QUICKENW\         Wait:        NO
Program:       WIN QW.EXE
Icon:          C:\MDESK\QUICKEN.ICN


MODIFYING YOUR AUTOEXEC.BAT FILE

You may want to add the necessary commands to your AUTOEXEC.BAT
file to run Magic Desk automatically when the computer is turned
on.  If you aren't familiar with the purpose and contents of your
AUTOEXEC.BAT file, you may want to have someone assist you.
Assuming the Magic Desk program files are on the C drive in the
\MDESK directory, you would add the following commands at the end
of your AUTOEXEC.BAT file (if the files are on a different drive
or directory, substitute the correct information):

     C:
     CD \MDESK
     MAGIC









                               19
===================================
COMPATIBILITY WITH EARLIER VERSIONS
===================================

The configuration files for this version of Magic Desk are not
compatible with earlier versions of ToyBox.

Icon files from earlier versions of ToyBox are compatible, except
the colors will probably not be correct.  You can read the icons
into Painter one at time and correct the colors.  The registered
version of Magic Desk includes a utility that will correct the
colors of all old icons in a specified directory in a single pass.






Magic Desk and ToyBox are trademarks of Virtual Magic Software.
Windows is a trademark of Microsoft Corporation.
MS-DOS is a registered trademark of Microsoft Corporation.
Quicken is a registered trademark of Intuit.

































                               20